home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Prog / Q-R / QB Graphics.sea / QB graphics help-text < prev    next >
Text File  |  1991-06-04  |  4KB  |  83 lines
  1. Help file for QuickBASIC graphics examples.
  2.  
  3. © 1991 Ralph Gonzalez, PO Box 54, Newark, DE 19711, USA.
  4.  
  5.  
  6.  
  7. INTRODUCTION:
  8.  
  9. These are Microsoft Macintosh QuickBASIC programs I developed for a 
  10. class on microcomputer graphics.  The programs cover graphics 
  11. primitives, segmentation, animation techniques, user interface design, 
  12. and 2D and 3D image transformation.  An attempt (!) was made to use good 
  13. code structure, including extensive use of subprograms and documentation 
  14. of potentially-obscure instructions (unlike the examples provided by 
  15. Microsoft!).  I chose to explicitly declare all variables even though 
  16. QuickBASIC doesn't require declaration of non-array variables.  The 
  17. limitations of Macintosh QuickBASIC (version 1.0 at the time of writing) 
  18. may have led to an overreliance on shared (global) variables, however.
  19.  
  20. An attempt was also made to avoid dependence on a particular machine 
  21. configuration.  All of these will work on any Macintosh, with the 
  22. exception of the antialiasing example which requires a color or gray-
  23. scale monitor, and patterns.bas, which should be modified if color is 
  24. not available.
  25.  
  26.  
  27. DISTRIBUTION/SUPPORT:
  28.  
  29. All these programs are free for non-commercial use.  Please help me 
  30. distribute them further by giving copies (including this help file) to 
  31. other interested persons.  Please contact me if you have comments or 
  32. suggestions.
  33.  
  34.  
  35. FILES:
  36.  
  37. QB graphics help    (this file)
  38. patterns.bas        color pattern-drawing exercise
  39. antialias.bas        demonstrates antialiasing using color/gray scale
  40. segmaker.bas        creates simple graphics segment and saves
  41.             it to a file.
  42. segview.bas        load segments from file (using suitable format)
  43.             and display them.
  44. dragger.bas        demonstrates using the mouse to "drag" a graphic
  45.             object, represented either as a list of
  46.             instructions, a segment, or a bitmap.
  47. event shell.bas        an application "skeleton", which may be used
  48.             as the basis for writing programs using the
  49.             standard Mac menu-window interface.  Includes
  50.             a complete File menu implementation.
  51. viewport.bas        for mapping 2D images from "world" coordinate
  52.             system "windows" to Mac "viewports".  Con-
  53.             fusingly, these viewports are usually termed
  54.             "windows" themselves.
  55. cube3d.bas        displays a 3D cube, with animation as the
  56.             mouse is moved.  Compile for better performance.
  57.  
  58.  
  59. NOTES:
  60.  
  61. The sequence above is that which I used for introducing these concepts.  
  62. The first few programs don't rely heavily on Macintosh-specific issues, 
  63. and can be easily rewritten for other computers.
  64.  
  65. Read the comments in the code for compilation instructions and for help 
  66. adapting the code to suit your own purposes.
  67.  
  68. I tried to stay within the "standard" machine-independent QuickBASIC 
  69. syntax when possible. Otherwise, I tried to use only built-in Macintosh 
  70. QuickBASIC statements; otherwise, I tried to use Macintosh ROM routines 
  71. which are keywords in Macintosh QuickBASIC (Appendix D of the QuickBASIC 
  72. 1.0 manual), otherwise I used existing QuickBASIC "Toolbox Library" 
  73. routines (Appendix E of the QuickBASIC 1.0 manual).  I never resorted to 
  74. using the "Toolbox" statement (E.10.3 in the manual) to access the 
  75. remaining Macintosh ROM routines directly, partly because I was 
  76. attempting to maintain SOME illusion of machine-independence!
  77.  
  78. Saving and opening these programs using the QuickBASIC built-in editor 
  79. will be much faster is you choose "Save As" and save them in the 
  80. "Compressed" format.  On the other hand, the Edit editor which is 
  81. distributed with QuickBASIC is often handy, and requires the file to be 
  82. saved as text.
  83.